home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / bildschirmschoner / snowblank / snowblank.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  6KB  |  143 lines
  1. @database xsnow.guide
  2. @node Main
  3. @toc Main
  4. This document gives You a short description of the snow screen blanker 
  5. modules for the GarshneBlanker system.
  6. Contents
  7.     @{" Introduction " link "Introduction"} - What is this all about?
  8.     @{" Installation " link "Installation"} - How to install them on Your Amiga
  9.     @{" The Blankers " link "Blankers"} - What do they do? How do You configure them?
  10.     @{" The Author   " link "Author"} - Shocking details!
  11.     @{" Legal Stuff  " link "Legal"} - Well... not really.
  12.     @{" Extend ...   " link "Extend"} ... xsnow if You want.
  13. @endnode
  14. @node Introduction
  15. @toc Main
  16. INTRODUCTION
  17. In my eternal struggle to write the most important and useful software
  18. available for the Amiga line of computers I'm glad announce my latest
  19. success: 
  20.            Snow Screenblankers for GarshneBlanker
  21. The problem is obvious: During the winter beautiful snowflakes are falling
  22. from the sky but many people don't even notice that because they are sitting
  23. at their Amigas and staring madly at their monitors. Not once can those 
  24. poor people look out of their windows and enjoy aesthetically falling snow.
  25. NOT ANYMORE! If You're installing these fine screen blankers for the 
  26. GarshneBlanker system You can stare madly at Your monitor just as before 
  27. and be able to see nice falling snow at the same time! 
  28. The archive You've just unpacked contains two blankers doing basically
  29. the same:
  30.    * snow displays falling snowflakes on a black screen. This blanker
  31.      is small and fast.
  32.    * xsnow display falling snowflakes in front of different backgrounds.
  33.      This blanker is larger, slower, more configurable.
  34. A final warning: These blankers took me about four hours to write so
  35. You will not see incredibly, never-seen-before graphics. Even worse,
  36. on slower Amigas these blankers shouldn't be very fast. Sorry. (No,
  37. I don't want to learn how to program BOBs and such :-) ).
  38. @endnode
  39. @node Installation
  40. @toc Main
  41. INSTALLATION
  42. To be able to use these blankers You need
  43.   * An Amiga with OS2.0 or later
  44.   * The GarshneBlanker system (version 3.6 = 38.8) installed somewhere
  45.   * Knowledge on where to put new blanker modules, how to copy files,
  46.     and what processor You've got.
  47. Installation is quite easy: All GarshneBlanker modules are located
  48. in one single directory. Look at the directory in this distribution
  49. corresponding to Your Amiga's processor and copy everything in it
  50. into this directory. Just like
  51. > cd SnowBlank/MC68030
  52. > copy #? to <blanker directory>
  53. Then quit and restart GarshneBlanker. Voila!
  54. If You're the lucky owner of an 68040 CPU You should install the 
  55. 68030 versions. There's no need to include separate 68040 versions -
  56. 68030 and 68040 optimizations yielded exactly the same executable.
  57. @endnode
  58. @node Blankers
  59. @toc Main
  60. THE BLANKERS
  61. The snow blanker shows falling snowflakes on a black screen. 
  62. You can change the following parameters:
  63.   * Snowflakes: Sets the number of snowflakes visible on the screen
  64.     at any time. You can select a value between 10 and 1000. If Your
  65.     Amiga is really very fast and You want to see huge amounts of
  66.     snow You can @{" change " link "change"} this range by hand.
  67.   * Flake Size: You can choose "small" or "big" snowflakes. Small
  68.     snowflakes are just single pixels, big snowflakes 3x3 pixels.
  69.   * Collect: If You select "Yes" here no snowflake will disappear
  70.     after it reaches the ground but stay there.
  71.   * Display: You can select any screenmode. The depth of the screen
  72.     is set to a fix value of 1.
  73. --------------------------------------------------------------------
  74. The xsnow blanker will draw some kind of "background picture" and
  75. do basically the same thing as snow afterwards. The background
  76. picture can consist of a landscape, trees, snowmen, and stars.
  77. The following parameters can be set:
  78.   * Every parameter of snow. All "Yes/No", "small/big" parameters
  79.     can have a value "random" which causes the module to choose 
  80.     Yes or No randomly when it starts.
  81.   * Stars: If this is selected the module will draw stars to the
  82.     sky. And they will even blink (wow! :-) ).
  83.   * Background: If this is set to "on", xsnow tries to draw a very
  84.     simple winter landscape.
  85.   * Snowmen: Set this is to "yes" to get (very simple) snowmen.
  86.   * Trees: Same for (very simple) trees.
  87.   * Objects: The number of objects (Snowmen, Trees) to draw to
  88.     the screen at most. This slide makes no sense if both "Snowmen"
  89.     and "Trees" are set to "no".
  90.   * Display: Like in snow. The depth is set to 4 here.
  91. @endnode
  92. @node change
  93. @toc Main
  94. HOW TO CHANGE THE LIMIT OF SNOWFLAKES
  95. To change the limits of snowflakes to be displayed You have
  96. to edit snow.ifc or xsnow.ifc. In this file, change the line
  97. SLIDER "S_nowflakes"    n 10 1000 200
  98. to e.g.
  99. SLIDER "S_nowflakes"    n 10 10000 2000
  100. and the snowflakes slider will go up to 10.000 (You need to
  101. select another blanker module and reselect snow/xsnow in order
  102. to see Your changes. Warning! My blankers expect this file to
  103. contain valid data. If You do stupid things here they will
  104. crash badly. For example, negative numbers are a certain way
  105. to crash my blankers.
  106. @endnode
  107. @node Author
  108. @toc Main
  109. THE AUTHOR
  110. I like to hear from You! If You've got another Amiga model than I do
  111. (I've got an A4000/30) please tell me if my blankers run on Your 
  112. configuration. If it doesn't work, it would be nice if You provided
  113. additional information (Your setup, what's happening).
  114. Send bug reports etc. to:
  115.    karlheinz.agsteiner@informatik.tu-chemnitz.de
  116.    (or simply kag@informatik.tu-chemnitz.de)
  117. My WWW page is located at
  118.    http://www.tu-chemnitz.de/~kag
  119. or (snail mail):
  120. Karlheinz Agsteiner
  121. Lessingstr. 10
  122. 09130 Chemnitz
  123. Germany
  124. @endnode
  125. @node Legal
  126. @toc Main
  127. LEGAL STUFF
  128. As I wrote above it took me just some hours to complete
  129. these blankers. They are really not worth being protected
  130. in any respect. Do what them what You like to.
  131. @endnode
  132. @node Extend
  133. @toc Main
  134. EXTEND XSNOW
  135. Well, I really would like to see a _nice_ snow blanker
  136. module. xsnow is just a first step. But I'm not good at
  137. drawing nice snowmen, trees etc. so it may look a bit
  138. "childish". If You have any idea (snowflakes falling on
  139. the WB screen like in xsnow, nicer landscapes, santa's
  140. sled like in xsnow) feel free to change xsnow and to
  141. submit it to aminet.
  142. @endnode
  143.